home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / dbase / fac163.zip / FAC.DOC < prev    next >
Text File  |  1992-01-05  |  74KB  |  1,683 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                        Find Area Code (FAC), Version 1.6
  17.                      Copyright 1990-92, All Rights Reserved
  18.  
  19.                                   Developed by
  20.                              Mountain Data Systems
  21.                            8531 East Dry Creek Place
  22.                               Englewood, CO  80112
  23.                              CompuServe: 72737,3237
  24.  
  25.  
  26.                                _______
  27.                           ____|__     |                (R)
  28.                        --|       |    |-------------------
  29.                          |   ____|__  |  Association of
  30.                          |  |       |_|  Shareware
  31.                          |__|   o   |    Professionals
  32.                        -----|   |   |---------------------
  33.                             |___|___|    MEMBER
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                    D I S C L A I M E R  -  A G R E E M E N T
  43.  
  44.              If you use Find Area Code (FAC), you must accept this
  45.           disclaimer of warranty:  "Find Area Code is supplied as is.
  46.            The author disclaims all warranties, expressed or implied,
  47.                 including, without limitation, the warranties of
  48.            merchantability and of fitness for any purpose. The author
  49.            assumes no liability for damages, direct or consequential,
  50.                which may result from the use of Find Area Code."
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.       Find Area Code Documentation
  60.      ----------------------------
  61.  
  62.  
  63.                            F I N D   A R E A   C O D E
  64.  
  65.                             D O C U M E N T A T I O N
  66.  
  67.                                 Table of Contents
  68.  
  69.                    o Introduction
  70.                    o What is Shareware?
  71.                    o The Association of Shareware Professionals (ASP)
  72.                    o Registration
  73.                    o What Do I Get for Registering, and Why Should I?
  74.                    o Installation
  75.                    o Using FAC from the DOS Command Line
  76.                    o The External Data File
  77.                    o Adding to the External Data File
  78.                    o Using FAC as a Popup TSR Program
  79.                    o What Are Swapping TSRs?
  80.                    o Advanced Options and Configuration
  81.                    o Error Conditions
  82.                    o Technical/Compatibility Notes
  83.                    o How to Reach the Author
  84.                    o Alternative Uses
  85.                    o Final Remarks
  86.                    o Quick Reference List of FAC Options
  87.  
  88.  
  89.  
  90.      Introduction
  91.      ------------
  92.  
  93.      Find Area Code (FAC) is an DOS utility which can quickly locate U.S.
  94.      and international telephone area codes or any other information you
  95.      store in its data files.  FAC performs its search using any part of an
  96.      area code, city, state, or country and shows matches almost instantly.
  97.      The program can also do "fuzzy" searches, allowing you to use
  98.      approximate, sound-alike spellings to find matches.
  99.  
  100.      FAC uses an ASCII data file (FAC.DAT) which you can change, update, or
  101.      add to whenever you like.  There are more than 2000 United States,
  102.      Canadian, and international cities in the database.  Also, without
  103.      leaving the program, you can append data to an external data file,
  104.      using a default or file name you specify.
  105.  
  106.      You can run FAC from the DOS command line or you can make it memory
  107.      resident (also known as a popup or Terminate and Stay Resident [TSR]
  108.      program).  When you install FAC as a memory resident program, you can
  109.      choose between a small (7K RAM) swapping version with a very short
  110.      (less than 2 seconds) delay while it swaps into memory from disk, or
  111.      you can have an instantly available popup which requires more RAM.
  112.      The swapping version can also (optionally) use Expanded Memory (EMS)
  113.  
  114.      -------
  115.      Page 2
  116.  
  117.       Find Area Code Documentation
  118.      ----------------------------
  119.  
  120.  
  121.      for almost instantaneous swapping.
  122.  
  123.      FAC displays the current date and time whenever the program is active.
  124.      The program automatically senses and supports all of the 25/43/50 line
  125.      modes used in most CGA/EGA/VGA video cards and pops up in the current
  126.      mode, using the screen most appropriately for that mode.  Also, FAC
  127.      senses the current color/monochrome mode and selects its colors
  128.      appropriately.  FAC's window can be moved around on the screen by
  129.      using  the cursor keys.  You can also "zoom" FAC's window to use the
  130.      full screen or allow the program to do so whenever required.
  131.  
  132.  
  133.      What is Shareware?
  134.      ------------------
  135.  
  136.      Although you may not have paid anything to get this copy of FAC, it is
  137.      not a free program.  It is distributed on a "shareware" basis.  What's
  138.      that?
  139.  
  140.      Shareware is a form of distribution which gives users a chance to try
  141.      software before buying it. If you try a Shareware program and continue
  142.      to use it, you are expected to register.  Individual programs differ
  143.      on details -- some request registration while others require it, some
  144.      specify a maximum trial period.  With registration, you get anything
  145.      from the simple right to continue using the software to an updated
  146.      program with printed manual.
  147.  
  148.      Copyright laws apply to both Shareware and commercial software, and
  149.      the copyright holder retains all rights, with a few specific
  150.      exceptions as stated below.  Shareware authors are accomplished
  151.      programmers, just like commercial authors, and the programs are of
  152.      comparable quality. (In both cases, there are good programs and bad
  153.      ones!)  The main difference is in the method of distribution.  The
  154.      author specifically grants the right to copy and distribute the
  155.      software, either to everyone, or to a specific group.  For example,
  156.      some authors require written permission before a commercial disk
  157.      vendor may copy their Shareware.
  158.  
  159.      Shareware is a distribution method, not a type of software.  You
  160.      should find software that suits your needs and pocketbook, whether
  161.      it's commercial or Shareware.  The Shareware system makes fitting your
  162.      needs easier, because you can try before you buy.  And because the
  163.      overhead is low, prices are low also.  Shareware has the ultimate
  164.      money-back guarantee -- if you don't use the product, you don't pay
  165.      for it.
  166.  
  167.      Find Area Code (FAC) is a "shareware program" and is provided at no
  168.      charge to you for your evaluation.  Feel free to share it with your
  169.      friends, but please do not give it away altered or as part of another
  170.      system.  The essence of "user-supported" software is to provide
  171.  
  172.      -------
  173.      Page 3
  174.  
  175.       Find Area Code Documentation
  176.      ----------------------------
  177.  
  178.  
  179.      personal computer users with quality software without high prices, and
  180.      yet to provide incentive for programmers to continue to develop new
  181.      products.
  182.  
  183.      Shareware works!  In addition to using many commercial products, I'm a
  184.      also a registered user of many high quality shareware products,
  185.      including:  PKWare's PKZIP, Vern Buerg's LIST, J.P. Software's 4DOS,
  186.      SemWare's QEdit Advanced, California Software Design's SHEZ,
  187.      ECONO-SOFT's Directory eXtended (DX), PC-*.*'s PC-TAX90, John Steed's
  188.      Brother's Keeper, and Falk Data System's Easy Format.  Please register
  189.      all shareware you continue to use.
  190.  
  191.      Please read the important information in the accompanying file,
  192.      LICENSE.DOC on the trial license for this program.  For more
  193.      information on shareware, please read the accompanying file
  194.      SHR-WARE.DOC.
  195.  
  196.  
  197.      The Association of Shareware Professionals (ASP)
  198.      ------------------------------------------------
  199.  
  200.      Mountain Data Systems is a member of the Association of Shareware
  201.      Professionals (ASP).  ASP wants to make sure that the shareware
  202.      principle works for you.  If you are unable to resolve a
  203.      shareware-related problem with an ASP member by contacting the member
  204.      directly, the ASP may be able to help.  The ASP Ombudsman can help you
  205.      resolve a dispute or problem with an ASP member, but does not provide
  206.      technical support for members' products.  Please write to the ASP
  207.      Ombudsman at 545 Grover Road, Muskegon MI 49442-9427 or send a
  208.      Compuserve message via CompuServe Mail to ASP Ombudsman 70007,3536.
  209.  
  210.  
  211.      Registration
  212.      ------------
  213.  
  214.      If you find FAC useful and you continue to use it after a reasonable
  215.      (45 days) trial period, you are required to make a registration
  216.      payment of $17.95 plus $2.00 shipping and handling (U.S.) to Mountain
  217.      Data Systems.  The $17.95 registration fee will license one copy for
  218.      use on any one computer at any one time.  Even after registering, you
  219.      have a money-back guarantee for 45 days after purchase.
  220.  
  221.      You must treat a registered version of this software just like a book.
  222.      Just as a book cannot be read by two different persons at the same
  223.      time, this software may be used by any number of people and may be
  224.      freely moved from one computer location to another, as long as there
  225.      is no possibility of it being used in two different locations at the
  226.      same time.
  227.  
  228.      Commercial users of Find Area Code (FAC) must register and pay for
  229.  
  230.      -------
  231.      Page 4
  232.  
  233.       Find Area Code Documentation
  234.      ----------------------------
  235.  
  236.  
  237.      their copies of the program within 45 days of first use or their
  238.      license is withdrawn.  For site-license information, see the file
  239.      SITELICE.DOC.
  240.  
  241.      You are encouraged to pass (unregistered) copies of Find Area Code
  242.      along to your friends for evaluation.  Please encourage them to
  243.      register their copy if they find that they can use it.  All registered
  244.      users will receive a copy of the latest version of FAC when they
  245.      register.
  246.  
  247.      Though the program is not "crippled" in anyway, this shareware version
  248.      shows an "Unregistered Shareware" status message in the lower right
  249.      part of the window to encourage you to register the program.  Also,
  250.      unregistered versions will give you a random (about 10% of the time),
  251.      bypassable registration reminder when you exit.  Naturally, the
  252.      registered version of the program doesn't have this.
  253.  
  254.      FAC is one of many area code finder utility programs, but I think
  255.      you'll find it is unsurpassed in speed, ease of use, convenience, and
  256.      price.  As far as I know, it is the ONLY area code finder capable of
  257.      being installed as a 7K memory resident program.  Please fill out the
  258.      included registration order form (file REGISTER.DOC) and send in your
  259.      registration today.  You can send REGISTER.DOC to your printer by
  260.      typing:
  261.  
  262.                  "COPY REGISTER.DOC PRN"  (without the quotes)
  263.  
  264.      and then pressing ENTER while at the MS-DOS prompt.
  265.  
  266.      To order FAC by normal surface mail, print and fill out the second
  267.      page of the REGISTER.DOC file, then mail it to the author with your
  268.      check, cash, or money order.  You can register FAC by credit card
  269.      through either Public (software) Library (PsL), a disk vendor, or
  270.      Software Excitement!, a CompuServe Electronic Mall vendor.  See
  271.      REGISTER.DOC for details.  Remember, both the above services are for
  272.      credit card orders only--not for support or other information!
  273.  
  274.  
  275.      What Do I Get for Registering, and Why Should I?
  276.      ------------------------------------------------
  277.  
  278.      When you register, you'll receive a disk with the latest version of
  279.      the program and a utility to stamp your serial number on all future
  280.      versions of the program.  Once you have registered FAC, you are always
  281.      entitled to the latest version at anytime.  You can download the
  282.      latest version from CompuServe, a BBS, or other computer service or
  283.      I'll send you the latest release for a small handling charge.  You can
  284.      either send me a SASE floppy mailer with your floppy, or just send me
  285.      $5.00 and I'll furnish the floppy, mailer, and postage.
  286.  
  287.  
  288.      -------
  289.      Page 5
  290.  
  291.       Find Area Code Documentation
  292.      ----------------------------
  293.  
  294.  
  295.      Here are some reasons why you should register:
  296.  
  297.        o You receive a CURRENT copy of the program, fresh from the author's
  298.          computer.
  299.  
  300.        o You get a LIFETIME license, meaning you're entitled to all future
  301.          versions/upgrades of FAC.
  302.  
  303.        o You get unlimited technical support via surface mail or electronic
  304.          mail.
  305.  
  306.        o You receive a special offer for a 1 year, discounted Shareware
  307.          Magazine subscription.
  308.  
  309.        o A free CompuServe IntroPak, which includes a $15.00 usage credit,
  310.          is available to Find Area Code registered users who do not yet
  311.          subscribe to CompuServe.  CompuServe will open the door for a
  312.          whole new world of information, services, and interesting people.
  313.          CompuServe is also the best place to obtain technical support for
  314.          FAC and other high-quality shareware and commercial products.
  315.          This CompuServe IntroPak (a $39.95 value) is provided to FAC
  316.          registered users compliments of CompuServe, Inc., and Mountain
  317.          Data Systems.
  318.  
  319.        o You have the author's ear when it comes to suggesting new features
  320.          and capabilities.  You may also be able to beta-test new versions
  321.          of the software before they are released to the general public.
  322.  
  323.        o You help increase competition in the software industry by keeping
  324.          prices low (shareware doesn't rely on expensive advertising).
  325.  
  326.        o Finally, you can be proud of the honesty and integrity you've
  327.          shown in registering the program and having participated in the
  328.          Shareware revolution.
  329.  
  330.  
  331.      Installation
  332.      ------------
  333.  
  334.      The Find Area Code distribution file is now created using PKZip's
  335.      Authenticity Verification (AV) feature.  This virtually guarantees
  336.      BBSs and users virus-free, unmodified files.  If after unzipping your
  337.      distribution files you don't see the message:
  338.  
  339.           "Authentic files Verified!   # EOA070   MICHAEL K. MOLLOY"
  340.  
  341.      you've have a modified distribution file.  Get another copy of the ZIP
  342.      file from me, CompuServe, another BBS, or another Disk Vendor.
  343.  
  344.      Once you've unzipped the distribution file, you can put Find Area
  345.  
  346.      -------
  347.      Page 6
  348.  
  349.       Find Area Code Documentation
  350.      ----------------------------
  351.  
  352.  
  353.      Code's files in any directory.  The FAC.EXE and FAC.DAT files can be
  354.      anywhere on the disk as long as you set a path to them with the DOS
  355.      PATH statement.  Note that FAC.DAT need not be in the same directory
  356.      as FAC.EXE as long they are both on the PATH.  For example, if you put
  357.      FAC's files in the C:\UTIL directory, you would need to have a PATH
  358.      statement in your AUTOEXEC.BAT file which might look something like
  359.      this:
  360.  
  361.                      PATH=C:\;C:\DOS;C:\MISC;C:\UTIL;C:\MENU
  362.  
  363.      You need at least 120K of disk space and 140K RAM to run the program
  364.      from the DOS prompt (non-TSR mode).  To use the program as a swapping
  365.      TSR, you must either have: an additional 265K of free disk space (hard
  366.      disk recommended); or 265K of expanded memory (EMS).
  367.  
  368.      Actually, FAC.EXE is the only you must have on your path.  If you are
  369.      running FAC from the same directory where FAC.DAT resides, FAC.DAT
  370.      need not be on your PATH.
  371.  
  372.      ------------------ For Registered Users Only -------------------------
  373.  
  374.      When you register FAC, you'll receive an additional program which is
  375.      used to "stamp" a registered serial number on your copy (and all
  376.      future copies) of your program.  Stamping the serial number also
  377.      removes the "Unregistered Shareware" reminder in the lower right part
  378.      of the window.
  379.  
  380.      To run this program, type "STAMP-SN" at the DOS prompt, and press
  381.      ENTER.  You'll be asked for the name of the EXE file to modify (since
  382.      FAC.EXE could be renamed to whatever you want).  If you're using
  383.      FAC.EXE, just press ENTER.  If the file is found on the PATH, it will
  384.      be stamped with a serial number identified with your registration.  Be
  385.      SURE to save your copy of STAMP-SN.EXE so you can use it with future
  386.      releases of FAC.
  387.  
  388.      If you're a user of various executable-file compression utilities like
  389.      LZEXE, PKLITE, or EXEPACK, you MUST run STAMP-SN on the unmodified
  390.      (uncompressed) original file BEFORE you use on of these utilities.  If
  391.      you try to run STAMP-SN on a compressed EXE file, you'll be unable to
  392.      stamp the serial number.
  393.  
  394.      If you are a registered user of FAC, you MAY NOT give anyone a copy of
  395.      the serial number stamped program, nor may you give anyone the
  396.      STAMP-SN.EXE program.
  397.      ----------------------------------------------------------------------
  398.  
  399.  
  400.      Using FAC from the DOS Command Line
  401.      -----------------------------------
  402.  
  403.  
  404.      -------
  405.      Page 7
  406.  
  407.       Find Area Code Documentation
  408.      ----------------------------
  409.  
  410.  
  411.      First, you must know how to invoke FAC from the DOS command line
  412.      prompt.  Type "FAC /H" (or "FAC /?" or "FAC /" or "FAC ?") then press
  413.      ENTER and you'll see a complete list of options you have for using
  414.      FAC.  Don't be alarmed at all the options.  FAC is very simple to use
  415.      and really requires only one thing--a string to search for. All the
  416.      options are for more advanced use.  FAC is designed to be very easy to
  417.      use without reference to documentation or help screens.
  418.  
  419.      FAC will immediately search for area code information if you enter the
  420.      search string as an DOS parameter after the program name.  If you
  421.      wish, you can simply type "FAC" to start the program without a
  422.      parameter.  You'll be prompted for a search string once inside the
  423.      program.  For example, suppose you wanted to know the area code for
  424.      Boulder, Colorado.
  425.  
  426.      At the DOS prompt, type: "FAC boulder" (without the quotes, of course)
  427.      then press ENTER.  The program will start, a window will popup on the
  428.      screen, and the program automatically begins its search.  Almost
  429.      instantly, you'll see information about the area code for Boulder.
  430.      The first column in the display window has the 3 digit area code 303
  431.      (international area codes aren't necessarily 3 digits).  The next
  432.      column shows the 2 character postal abbreviation for Colorado, CO.
  433.      The third column shows the full name of the state.  The last column
  434.      shows the major cities in this particular area code.  Notice Boulder
  435.      appears in this list.  When you've finished with the program, just
  436.      press Esc and you'll exit back to DOS.
  437.  
  438.      Let's take another example.  Suppose someone leaves you a note to call
  439.      someone in a 309 area code.  You don't recognize this area code and
  440.      it's inconvenient to look up the area code in the phone book. You type
  441.      "FAC 309" then press ENTER.  Almost instantly, you learn that the 309
  442.      area code includes Peoria, Moline, and Rock Island, Illinois.
  443.  
  444.      Searching for an international area code is almost exactly the same.
  445.      Just type in a city name, say Paris.  The program will display the
  446.      country code in the first column, the country name in the next column
  447.      (there is no postal abbreviation for most foreign countries), and a
  448.      list of major cities and city codes for that country in the last
  449.      column.  Each  city code is listed in parentheses immediately after
  450.      the city name.  If you searched for Paris, you would know the country
  451.      code for France is 33 and the city code for Paris is 1.
  452.  
  453.      Anytime you see a city name in all CAPITAL letters, that city is a
  454.      state or country capital.
  455.  
  456.      You get the idea.  By typing "FAC X" where X is any alphanumeric
  457.      string, you can quickly search the area code database.  You can search
  458.      by area code, state postal abbreviation, state name, country, city, or
  459.      any portion of thereof.  The search string can be in any combination
  460.      of upper or lower case letters and numbers. and must be at least two
  461.  
  462.      -------
  463.      Page 8
  464.  
  465.       Find Area Code Documentation
  466.      ----------------------------
  467.  
  468.  
  469.      characters.  If you use only two characters, the program assumes you
  470.      want to search for two-letter state postal abbreviations which appear
  471.      only in the first 7 characters of each line.  The program doesn't look
  472.      at anything else on the line except these first 7 characters.  Note:
  473.      this restriction does not apply to the data in the external data file
  474.      (see the section below on The External Data File).
  475.  
  476.      After you've performed a search, the last string searched for is shown
  477.      after the prompt.  To enter a new string, just start typing it in (the
  478.      old string will go away when you press the first character). You can
  479.      also edit the existing string by using the following keys:
  480.  
  481.          Left Arrow       - Cursor left one character
  482.          Right Arrow      - Cursor right one character
  483.          Ctrl-Left Arrow  - Cursor left one word
  484.          Ctrl-Right Arrow - Cursor right one word
  485.          Home             - Cursor to the beginning of the string
  486.          End              - Cursor to the end of the string
  487.          Del              - Delete the character under the cursor
  488.          BkSp             - Delete the character the left of the cursor
  489.          Ctrl-Y           - Delete the entire string
  490.          Ctrl-End         - Delete from the cursor to the end of the string
  491.          Ctrl-Home        - Delete from start of line to the cursor
  492.          Ctrl-T           - Delete word to the right of the cursor
  493.          Ins              - Toggle between Overwrite and Insert mode
  494.          Ctrl-R           - Restore the original contents of the line
  495.          ENTER            - Start searching for the specified string
  496.  
  497.      Search strings are limited to 20 characters.  Spaces entered at the
  498.      beginning and end of the search string are ignored (and discarded),
  499.      but spaces anywhere else in the string are valid.  This means you
  500.      could search for "San Francisco" but not for " San Francisco ".
  501.  
  502.      You can make any number of searches before exiting the program.
  503.      Remember, just press Esc to exit the program (Ctrl-C or Ctrl-Break
  504.      will also exit).
  505.  
  506.      While you're inside FAC, you can get brief help by pressing F1. This
  507.      shows you that F1 gets help, F2 toggles the "Fuzzy" search mode, F5
  508.      prompts you for new data to add to an external data file, F9 toggles
  509.      the AutoZoom screen size feature, F10 toggles screen zooming, and Esc
  510.      exits the program.  You can reposition FAC's window up and down on the
  511.      screen by pressing the up and down arrow keys.
  512.  
  513.      Sometimes, your search string will find more information than can be
  514.      displayed in the window.  If the screen fills up with information, the
  515.      program will pause and prompt you to press the Esc key to stop
  516.      displaying information from the current search, or press any other key
  517.      to continue displaying information.  If you press Esc to stop
  518.      displaying information, you'll be returned to FAC's prompt.  Pressing
  519.  
  520.      -------
  521.      Page 9
  522.  
  523.       Find Area Code Documentation
  524.      ----------------------------
  525.  
  526.  
  527.      Esc once more will exit the program.
  528.  
  529.      If FAC doesn't find a match for your search string in its data file,
  530.      you'll see a brief message in the center of the window saying that the
  531.      string couldn't be found.  You can then edit the search string if you
  532.      wish.
  533.  
  534.      Once you've experimented with FAC, you may notice that sometimes it
  535.      pops up in the upper half of your screen and sometimes it pops up in
  536.      the lower half.  Why?  FAC looks at where the cursor is positioned and
  537.      brings up the FAC window in the opposite half of the screen you're
  538.      working in.  This insures the program doesn't obscure something you
  539.      may need to see while you're using the program.
  540.  
  541.      FAC also shows you today's date and the current time (in 24-hour
  542.      format) at the top center of the program's window while the program is
  543.      on the screen.  See the Advanced Options and Configuration section for
  544.      selecting 12/24 hour clock format with the /C switch.
  545.  
  546.      The other thing you may have noticed is that FAC pops up in whatever
  547.      mode (25, 43, or 50 lines) your video card is in.  FAC automatically
  548.      checks to see how many lines you're using at the moment and adjusts
  549.      its windows accordingly.  FAC isn't designed to support 40 column
  550.      mode, but will safely pop up (although you won't like what you see).
  551.      FAC won't popup at all when you're in graphics mode.
  552.  
  553.      One final note on using FAC from the command line.  You can "redirect"
  554.      the output from the program's status messages and so forth by using
  555.      standard MS-DOS redirection conventions.  For example, if you didn't
  556.      want info on the program's installation to appear on the screen while
  557.      booting up, you could install FAC like this:
  558.  
  559.                                   FAC /I >NUL
  560.  
  561.      When FAC installs, you wouldn't see messages from the program at all.
  562.  
  563.      If you want to, you could use the redirection capability to send FAC
  564.      status messages to a file or to the printer.
  565.  
  566.           FAC -H >FILENAME.EXT   This would send help info to FILENAME.EXT
  567.           FAC -H >PRN            This would send help info to the printer
  568.  
  569.      PLEASE NOTE:  If you redirect FAC's output to a file when you install
  570.      it as a memory resident program, that file remains "open" and is not
  571.      "released" back to MS-DOS normally until you uninstall FAC using the
  572.      /U option (or until you reboot your computer).  This is normally not a
  573.      problem, but could be if you had an extreme number of files open.  If
  574.      you have problems, try using a larger FILES entry in your CONFIG.SYS
  575.      file (if you're currently using FILES=24, try using FILES=28).  Again,
  576.      this is only when you redirect output when installing FAC as a TSR.
  577.  
  578.      -------
  579.      Page 10
  580.  
  581.       Find Area Code Documentation
  582.      ----------------------------
  583.  
  584.  
  585.  
  586.      You cannot redirect any of the windows or output from the running
  587.      program.
  588.  
  589.  
  590.      The External Data File
  591.      ----------------------
  592.  
  593.      FAC uses its own data file, FAC.DAT to store area code information so
  594.      that you can search for it.  This file contains ASCII text which you
  595.      can  modify to update or correct area codes, or for any other purpose.
  596.      Many users use FAC to keep track of their own personal information
  597.      (see the section toward the end of this document on Alternative Uses).
  598.      Beginning with FAC Version 1.50, your data can be stored in a data
  599.      file external to the FAC.DAT file.  This allows you to maintain your
  600.      own file of information and keep it separate from the area codes in
  601.      the FAC.DAT file.
  602.  
  603.      The default external data file, MY-DATA.DAT is automatically searched
  604.      if it exists in: the directory you're currently PATHed to; the
  605.      directory where FAC.EXE resides; or elsewhere on the path defined by
  606.      the DOS PATH statement most people have in their AUTOEXEC.BAT file.
  607.      If a line in the MY-DATA.DAT file contains the string you're searching
  608.      for, it will be displayed in FAC's window after the FAC.DAT file is
  609.      searched.  Text found in the external data file will be displayed in
  610.      dimmer characters than text found in the FAC.DAT file so you'll know
  611.      where the information came from.
  612.  
  613.      If you specify a different external data file via the /D switch (see
  614.      Advanced Options and Configuration), the specified file will be
  615.      searched instead of the MY-DATA.DAT file.  This file can be anywhere
  616.      on the disk, but if it isn't in one of the places where FAC looks for
  617.      MY-DATA.DAT, you must use the /D switch to specify the full disk,
  618.      directory and file name.
  619.  
  620.      The external data file can contain any text you wish.  This can be a
  621.      file you create, or it can be a pre-existing file like a BBS listing.
  622.      FAC expects the file to be "line-oriented".  This means that if you're
  623.      searching a text document for two words which are on different lines,
  624.      FAC won't be able to find the line.
  625.  
  626.  
  627.      Adding to the External Data File
  628.      --------------------------------
  629.  
  630.      You can add your own information to the external data file in two
  631.      ways.  You can use a text editor or word processor to create and
  632.      maintain the file, or you can you use FAC's internal capability to add
  633.      data to the external data file.
  634.  
  635.  
  636.      -------
  637.      Page 11
  638.  
  639.       Find Area Code Documentation
  640.      ----------------------------
  641.  
  642.  
  643.      If you use an editor to create or modify the external data file, you
  644.      must adhere to two rules: 1) you must save the file in pure ASCII
  645.      format; and 2) each line must not exceed 119 characters.  You can add
  646.      your information anywhere in the file in any order.  Once you've added
  647.      a line to the file, FAC will be able to search for that information if
  648.      the file is the default or specified external data file.
  649.  
  650.      While using FAC, you can press F5 to add a new line of data to the end
  651.      of the default or specified external data file.  Just press F5, and
  652.      you'll see a status message indicating you're adding data.  On the
  653.      bottom line of the window, you'll see a prompt for the new data to
  654.      add.  Type in the line of information at the prompt and press ENTER
  655.      when you're satisfied with the way the information looks.  You can use
  656.      the same keys, described above, to edit this line as you use to edit
  657.      the search string.  You'll automatically be limited to 119 characters.
  658.      If MY-DATA.DAT doesn't exist, the file will be created in the same
  659.      directory which contains FAC.EXE.  If you specified an external data
  660.      file with /D, the file must already exist, or the program won't start.
  661.  
  662.      When you press ENTER, you'll see a status message that the new data
  663.      was added to either the default or specified external data file.  Now
  664.      you can search for the information.  Press F5 to add another line of
  665.      information to the external data file.
  666.  
  667.      When you add data to the external data file, your information is
  668.      appended to the very end of the file--it isn't sorted in any way.  If
  669.      you want the file sorted, use a separate utility like Vern Buerg's
  670.      excellent SORTF.COM (current version as of this date is SORTF237.ZIP).
  671.      Note that it really isn't necessary to have the file sorted since the
  672.      entire file is searched each time.  Even you don't know where
  673.      something is in the file when you edit it, you can always use your
  674.      editor's search function to find the line you want.
  675.  
  676.  
  677.      Using FAC as a Popup TSR Program
  678.      --------------------------------
  679.  
  680.      More often than not, when you're at your computer and you need area
  681.      code information, you're in the middle of doing something else.  To
  682.      use FAC as described above, you must save your work, exit the program
  683.      you're using, then invoke FAC.  FAC would tell you what you need to
  684.      know, then you would have to restart your original program, go back to
  685.      where you left off, and try to go back to work.
  686.  
  687.      It would be much more convenient if you could simply have FAC
  688.      immediately "popup" over whatever you're doing, give you the
  689.      information you need, then go away, leaving you exactly where you
  690.      were.  Not only would it be more convenient, it would save a lot of
  691.      your valuable time.
  692.  
  693.  
  694.      -------
  695.      Page 12
  696.  
  697.       Find Area Code Documentation
  698.      ----------------------------
  699.  
  700.  
  701.      FAC can do this.  All you have to do is tell FAC to install itself as
  702.      a "popup" or memory resident program.
  703.  
  704.      You'll also see this type of program called a TSR, which stands for
  705.      Terminate & Stay Resident.  A TSR is installed or loaded once from the
  706.      DOS command line.  It stays in memory even while you're doing other
  707.      things, and watches to see when you press a special key or key
  708.      sequence to activate it.  This special key sequence is known as a
  709.      "hotkey".  When you press the hotkey, the program starts.
  710.  
  711.      Here's how to install FAC as a memory resident, popup program.  At the
  712.      DOS prompt, type: "FAC /I" (without the quotes) then press ENTER.  FAC
  713.      will then install itself in memory as a TSR.  When it has successfully
  714.      installed itself, it will describe how it has been installed.  In this
  715.      case, you will use FAC's defaults.
  716.  
  717.      Once you've installed FAC as described above, you can press FAC's
  718.      hotkey to pop it up wherever you are.  FAC's hotkey is
  719.      <Alt><LeftShift><F>.  To press this key sequence, press and hold the
  720.      "Alt" key, press and hold the Shift key on the left side of your
  721.      keyboard, then press the F key.  As soon as all three keys are
  722.      pressed, FAC will "wake up" and activate itself.
  723.  
  724.      FAC will put its window on the screen right over the top of whatever
  725.      you're doing.  Don't worry.  When FAC is done, it will return the
  726.      screen to exactly the way it found it.
  727.  
  728.      When you invoke the TSR version of FAC as installed above, it works
  729.      somewhat differently than it does when you start it from the DOS
  730.      prompt.  Recall that when you run the program from the DOS prompt, you
  731.      must enter a parameter (search string) so FAC knows what to search
  732.      for. When FAC operates as a TSR, it can read the text string (state,
  733.      area code, city, etc.) you want to search for right off the screen by
  734.      looking at the word "under" or to the left of where you have the
  735.      cursor positioned!  (You can turn off reading the search string from
  736.      the screen by using the /G switch.  See Advanced Options and
  737.      Configuration.)  If the cursor isn't in a word or just to the right of
  738.      a word, no search string will be passed to FAC, but it will still pop
  739.      up.  Reading the search string from the screen can save you time
  740.      typing in what to search for and it can avoid errors you might make
  741.      while typing.
  742.  
  743.      So, what happens?  You press the hotkey, FAC pops up over your work,
  744.      reads the text "under" the cursor, and immediately begins its search.
  745.      After it finds and displays a match, it prompts you for another
  746.      search.  Now the program operates exactly the way it does when used
  747.      from the DOS prompt.
  748.  
  749.      If you use the up/down arrow keys to reposition the normal FAC window,
  750.      the position you choose will be retained the next time you press the
  751.  
  752.      -------
  753.      Page 13
  754.  
  755.       Find Area Code Documentation
  756.      ----------------------------
  757.  
  758.  
  759.      hotkey.  Note that this means that because you've repositioned the
  760.      window, it may pop up and obscure text near the cursor.  If this is a
  761.      problem or you want to "reset" window positioning to pop up in the
  762.      opposite half of the screen from the cursor, just press F10 (once if
  763.      you are zoomed, twice if you aren't zoomed) and the automatic
  764.      positioning will be restored.
  765.  
  766.      You can press F10 to zoom FAC's window to take up the full screen, and
  767.      the program will "remember" to pop up in this mode the next time you
  768.      press the hotkey.
  769.  
  770.      When you want to exit, press Esc, and FAC will collapse its window,
  771.      and restore your screen and cursor location exactly the way it
  772.      appeared when you pressed the hotkey.
  773.  
  774.      If you want to uninstall FAC as a memory resident program (TSR), you
  775.      have two choices.  You can uninstall FAC from the command line by
  776.      using the /U switch, or you can press Alt-U twice while inside FAC's
  777.      window.  After you press Alt-U a second time, the program will exit
  778.      and will uninstall itself from memory.
  779.  
  780.  
  781.      What Are Swapping TSRs?
  782.      -----------------------
  783.  
  784.      You may have noticed that when you pressed the hotkey, a reverse video
  785.      message appeared on the bottom of the screen which said "Swapping
  786.      in..."  Similarly, when you pressed Esc to exit the program, "Swapping
  787.      out..." appeared.  These messages tell you the program is swapping
  788.      into and out of memory (RAM) from disk or expanded memory (EMS).  Why
  789.      does the program do this?
  790.  
  791.      When swapping TSRs install, they take a snapshot of the complete
  792.      program and write it out to a "swap file" on disk (or use EMS memory),
  793.      then free up all but a tiny portion of memory (which holds the portion
  794.      of the program which watches for the hotkey and then does the actual
  795.      swapping to/from disk).  When swapping TSRs pop up over your existing
  796.      program, they may also have to take a snapshot of your application and
  797.      write it to disk or EMS memory before it swaps the rest of the TSR in.
  798.      So why do we want to put up with all this swapping in and out? Doesn't
  799.      this cause delays?  Why can't the program just pop up instantly like
  800.      some of my other TSRs?
  801.  
  802.      Well, like everything else in the world, there are tradeoffs.  In
  803.      order to run full-featured, advanced programs, it takes memory (RAM).
  804.      The more full-featured the program, the more memory it takes.
  805.      Unfortunately, memory is a limited resource and "full-featured" often
  806.      translates to "memory-hungry."  FAC has many features but still only
  807.      requires about 128K of RAM to run.  This isn't a problem if FAC is the
  808.      only program you want to run, but it's a big problem if you want FAC
  809.  
  810.      -------
  811.      Page 14
  812.  
  813.       Find Area Code Documentation
  814.      ----------------------------
  815.  
  816.  
  817.      to be loaded as a TSR at the same time you're running other
  818.      (full-featured) programs.
  819.  
  820.      When FAC is installed as a swapping TSR, it only requires about 7K of
  821.      RAM to watch for you to press the hotkey and then swap what you're
  822.      doing out and swap itself in.  With all the other TSRs you use and the
  823.      other programs you run, you need all the help you can get.  The TSR
  824.      swapping technology FAC uses helps you optimize all the memory you
  825.      have with very little impact on how you use the program.  As computers
  826.      continue to become faster and more powerful, you'll see more and more
  827.      swapping TSRs.
  828.  
  829.      The time you spend waiting on swapping is relatively trivial compared
  830.      to the time it takes to leave your application, then return.  On even
  831.      the slowest computers, swapping delays are only about 1 or 2 seconds.
  832.      On faster computers using EMS memory for swapping, the TSR can pop up
  833.      instantaneously, for all practical purposes.  Of course swapping
  834.      delays can be affected by a wide range of hardware and software
  835.      variables.  Fast hard disks with 1:1 interleaves and high data
  836.      transfer rates make a huge difference, even when used on an 808X CPU.
  837.      If you're able to use EMS memory, RAM Disk, or disk caching (hardware
  838.      or software) you'll find swapping delays to be negligible or even
  839.      unmeasurable.  See the section below on Advanced Options and
  840.      Configuration for information on how to reduce swapping delays.
  841.  
  842.      The bottom line: I think the tradeoffs (swapping delays) are
  843.      completely acceptable given the tremendous savings in your precious
  844.      RAM. I think you'll think so, too!
  845.  
  846.  
  847.      Advanced Options and Configuration
  848.      ----------------------------------
  849.  
  850.      FAC has several different options or "switches" you can use to
  851.      customize the way FAC works when you invoke the program or install it
  852.      as a popup.  Again, FAC is designed to be very easy to use, and you
  853.      may be perfectly happy with FAC's performance when you use its default
  854.      options.
  855.  
  856.      Switch options are always preceded by either a "/" or a "-" and can be
  857.      upper or lower case letters.  Remember, to see a complete list of all
  858.      FAC's options, just type "FAC /H" at the DOS prompt and press ENTER.
  859.      Here's a quick summary of FAC's switches:
  860.  
  861.          /A     Don't make disk swap files hidden/system file(s); (with /I)
  862.          /B     Don't use color attributes; use monochrome attributes
  863.          /C     Don't use 24-hour clock format; use 12-hour format
  864.          /D     Use the specified file for the external data file
  865.          /E     Don't use EMS memory for swapping (use disk); (with /I)
  866.          /F     Enables "fuzzy search" mode
  867.  
  868.      -------
  869.      Page 15
  870.  
  871.       Find Area Code Documentation
  872.      ----------------------------
  873.  
  874.  
  875.          /G     Don't read text from screen on popup; (with /I)
  876.          /H     Show a list and description of the various switch options
  877.          /I     Loads popup/TSR with defaults
  878.          /M     Suppresses swapping messages (with /I)
  879.          /N     No swapping (with /I)
  880.          /P     Path for swap files; used (with /I)
  881.          /T     Don't use the AutoZoom feature
  882.          /U     Unload popup from memory, if possible
  883.          /X     Don't use exploding windows
  884.          /Z     Use a "zoomed" window which uses the full screen
  885.  
  886.      Most of these switches can be used in either of two ways: 1) as
  887.      command line switches, entered when the program is run; or 2) entered
  888.      as part of an environment variable called "FAC".  If you wanted the
  889.      program to use the fuzzy search mode, you could simply enter  "FAC
  890.      bolder /f" and the search would take place, using the fuzzy search.
  891.      But, what if you wanted FAC to ALWAYS start in (default to) fuzzy
  892.      mode?  This is where the FAC environment variable would be used.  Use
  893.      the SET command to assign a string to the FAC environment variable:
  894.  
  895.                                     SET FAC=/f
  896.  
  897.      If you entered this before running FAC or had this line in your
  898.      AUTOEXEC.BAT file, FAC would always start in fuzzy mode without having
  899.      to enter it on the command line when you start the program.
  900.  
  901.      Suppose you always wanted FAC to use fuzzy search mode, zoomed
  902.      windows, non-exploding windows, and when installed as a TSR: no
  903.      swapping messages with a swap file path of d:\temp and without getting
  904.      search strings from the screen.  Instead of entering each of these
  905.      switches each time you run the program, you would use the following
  906.      environment variable entry, preferably in your AUTOEXEC.BAT file:
  907.  
  908.                        SET FAC=/f /Z -x /M -pd:\temp /g
  909.                                 ^  ^  ^  ^  ^         ^
  910.      Fuzzy mode ----------------|  |  |  |  |         |
  911.      Zoomed window ----------------+  |  |  |         |
  912.      Non-exploding window ------------+  |  |         |
  913.      Swapping messages off --------------+  |         |
  914.      Swap path -----------------------------+         |
  915.      Don't get search string from screen -------------+
  916.  
  917.      Now, every time FAC is run the above settings will be the defaults. If
  918.      you install the program as a TSR, these settings will be the default
  919.      settings unless you change them after invoking the program with the
  920.      hotkey.  If you change them while TSR, that change will remain
  921.      effective until the next time you change it.
  922.  
  923.      Note the use of both a slash and dash as switch characters and the
  924.      mixed use of upper and lower characters.  You can use all FAC option
  925.  
  926.      -------
  927.      Page 16
  928.  
  929.       Find Area Code Documentation
  930.      ----------------------------
  931.  
  932.  
  933.      switches in the SET FAC environment variable except /I and /U.  You
  934.      can use any combination of switches in any order.  Invalid switch
  935.      settings will be ignored.  If you enter a swap path with the /P
  936.      switch, it will be checked for validity prior to program execution.
  937.  
  938.      The following section is a complete description of all FAC option
  939.      switches listed in alphabetical order.
  940.  
  941.  
  942.      The "/A" Switch
  943.      ---------------
  944.  
  945.      When used with /I (and when disk is used for swapping), uses swap
  946.      files with "normal" file attributes rather than hidden/system
  947.      attributes.  Can be used in the FAC environment variable.
  948.  
  949.      The /A switch says, "When FAC is installed as a TSR using disk for
  950.      swapping, don't use hidden/system attributes on the swap file(s)."
  951.      This switch allows you to control the file attribute used on the swap
  952.      files.  When the swap files have the hidden/system attribute set, some
  953.      disk defragmenting programs may be unable to defragment them.
  954.  
  955.      NOTE: If you use this switch, be SURE not to delete the swap file(s)
  956.      while FAC is memory resident (TSR).  If this file isn't present when
  957.      the program tries to swap itself in, you'll probably have to reboot
  958.      your computer to recover.
  959.  
  960.      The default is to use hidden/system attributes on the swap file(s)
  961.      when swapping to disk.  This switch does nothing if EMS is being used.
  962.  
  963.      Example: "FAC /I /A"
  964.  
  965.      In this example (if EMS wasn't available), the swap files would have
  966.      normal attributes instead of hidden/system attributes.
  967.  
  968.  
  969.      The "/B" Switch
  970.      ---------------
  971.  
  972.      Used for both non-TSR and TSR.  Can be used in the FAC environment
  973.      variable.
  974.  
  975.      This option or program "switch" applies to FAC when run from the DOS
  976.      prompt (non-memory resident mode) or when you install it as a popup.
  977.      If you use the "/B" switch, FAC will use only black and white
  978.      (monochrome) attributes for its text and window displays.  If you have
  979.      a monochrome system, FAC will normally be able to detect this and
  980.      automatically use monochrome attributes.  If you use a system which
  981.      has a color card, running in color mode, but have a monochrome
  982.      monitor, you should use the /B switch or use the DOS MODE command
  983.  
  984.      -------
  985.      Page 17
  986.  
  987.       Find Area Code Documentation
  988.      ----------------------------
  989.  
  990.  
  991.      (e.g., MODE BW80).  You may also want to use the /B switch if you have
  992.      a laptop or notebook computer with a liquid crystal display (LCD).
  993.  
  994.      The default is to use color attributes if you system is using the
  995.      color mode.
  996.  
  997.      If you want to disable the use of color attributes when you run the
  998.      program from the DOS command line (non-TSR), just put the /B switch
  999.      after your search parameter.
  1000.  
  1001.      Example:  "FAC City /B"
  1002.  
  1003.      When the program starts, the window and its contents would start out
  1004.      using monochrome or black and white screen attributes.
  1005.  
  1006.  
  1007.      The "/C" Switch
  1008.      ---------------
  1009.  
  1010.      Used for both non-TSR and TSR.  Can be used in the FAC environment
  1011.      variable.
  1012.  
  1013.      This option or program "switch" applies to FAC when run from the DOS
  1014.      prompt (non-memory resident mode) or when you install it as a popup.
  1015.      If you use the "/C" switch, FAC will use a normal (12-hour, am/pm)
  1016.      clock rather than the 24-hour time format.
  1017.  
  1018.      The default is to use the 24-hour clock format.
  1019.  
  1020.      If you want to disable the use of the 24-hour time format, when you
  1021.      run or install the program, just use the /c switch.
  1022.  
  1023.      Example:  "FAC City /C"
  1024.  
  1025.      When the program starts, the clock in the top center of the window
  1026.      will be displayed in the 12-hour time format.
  1027.  
  1028.  
  1029.      The "/D" Switch
  1030.      ---------------
  1031.  
  1032.      Used when FAC is run from the command line or when it's installed as a
  1033.      TSR.  Can be used in the FAC environment variable.
  1034.  
  1035.      The /D switch, when followed by a filename specification, says, "use
  1036.      the specified file name as the external data file to search or add
  1037.      information to."  The file specification must be a valid, already
  1038.      existing file on your system and must reside in: the current
  1039.      directory, the directory where FAC.EXE resides, or in a directory
  1040.      defined by the DOS PATH statement.  If the file doesn't exist, or
  1041.  
  1042.      -------
  1043.      Page 18
  1044.  
  1045.       Find Area Code Documentation
  1046.      ----------------------------
  1047.  
  1048.  
  1049.      can't be found, FAC will abort with an error message.  If you know the
  1050.      file exists, make sure it is one of the three places described above.
  1051.      If the file doesn't exist, you must create it.  To create a new file,
  1052.      use a text editor or use
  1053.  
  1054.                            COPY CON FILENAME.EXT <ENTER>
  1055.  
  1056.      then type in text to be entered in the file.  When you're done, press
  1057.      F6 to create the end of file marker then press ENTER to save the file.
  1058.  
  1059.      The default is to use the file MY-DATA.DAT.
  1060.  
  1061.      Examples: "FAC /Dstuff.txt"
  1062.  
  1063.      This example would start up FAC using the file STUFF.TXT as the
  1064.      external data file instead of the default, MY-DATA.DAT.
  1065.  
  1066.  
  1067.      The "/E" Switch
  1068.      ---------------
  1069.  
  1070.      When used with /I; don't use Expanded Memory (EMS) when it's
  1071.      available.  Can be used in the FAC environment variable.
  1072.  
  1073.      The /E switch says, "even if EMS memory is present, don't use it for
  1074.      swapping--use disk instead."  This switch prevents the program from
  1075.      automatically allocating your EMS memory.  Note that using EMS memory
  1076.      greatly speeds up swapping; you should use it if possible.
  1077.  
  1078.      The default is to use EMS memory for swapping.
  1079.  
  1080.      Example: "FAC /I /E"
  1081.  
  1082.      This example disables the use of EMS memory for swapping when FAC is
  1083.      installed as a TSR.
  1084.  
  1085.  
  1086.      The "/F" Switch
  1087.      ---------------
  1088.  
  1089.      Used for both non-TSR and TSR.  Can be used in the FAC environment
  1090.      variable.
  1091.  
  1092.      The /F switch says, "Use a 'fuzzy' search method which doesn't require
  1093.      an exact spelling to get a match."  When you use the /F switch, you
  1094.      tell the program to use a powerful text matching technique called the
  1095.      soundex algorithm.  Soundex searches attempt to match words based on
  1096.      the way they sound rather than by how they're spelled.  If you aren't
  1097.      sure how a city, state, or country is spelled, or you're getting a
  1098.      'not found' message with the string you're using, try the /F switch.
  1099.  
  1100.      -------
  1101.      Page 19
  1102.  
  1103.       Find Area Code Documentation
  1104.      ----------------------------
  1105.  
  1106.  
  1107.  
  1108.      There is a price to pay for the soundex searching method: speed.
  1109.      Searches may take up to 10 times as long as normal "exactly spelled"
  1110.      searches, but this is well worthwhile if it's the only way you can
  1111.      find what you're looking for.  You may also get a lot more seemingly
  1112.      unrelated "hits" from a fuzzy search, but this is normal.  After all,
  1113.      you're looking for anything that closely resembles or sounds like your
  1114.      search string.
  1115.  
  1116.      Since fuzzy searches take longer, you may need to stop the search
  1117.      before it completes.  You can press any key during the fuzzy search
  1118.      and it will stop and return to the program's prompt.
  1119.  
  1120.      Once you're inside FAC, you can use the F2 key to toggle between
  1121.      normal searching and fuzzy searches (there's an indicator on in the
  1122.      top center of the window frame when you're in fuzzy mode).  If you've
  1123.      installed FAC as memory resident program, the program will remember
  1124.      whether you were in fuzzy mode the last time you used it.
  1125.  
  1126.      Examples: "FAC Colorawdo /f" "FAC springfeild /f"
  1127.  
  1128.      In both these examples, the program would immediately start searching
  1129.      for the specified strings, but the 'Fuzzy Search' indicator would be
  1130.      on at the top center of the window frame, and you would also see a
  1131.      flashing message telling you the search is in progress.  The first
  1132.      example would give you "hits" for Colorado, even though it's
  1133.      misspelled.  The second example would find three instances of
  1134.      Springfield as you might expect, but also yields Palm Springs,
  1135.      Steamboat Springs, Colorado Springs, and Big Spring.
  1136.  
  1137.  
  1138.      The "/G" Switch
  1139.      ---------------
  1140.  
  1141.      When used with /I; don't get search strings from the screen in TSR
  1142.      mode.  Can be used in the FAC environment variable.
  1143.  
  1144.      The /G switch says, "When you popup FAC, don't read the text to search
  1145.      for off the user's screen; just ask for a string."  This switch
  1146.      prevents you from grabbing the search string from the screen and
  1147.      requires you to enter it yourself.
  1148.  
  1149.      The default is to read the screen for the text to search for.
  1150.  
  1151.      Example: "FAC /I /G"
  1152.  
  1153.      This example disables reading the text from the screen when FAC is
  1154.      popped up.
  1155.  
  1156.  
  1157.  
  1158.      -------
  1159.      Page 20
  1160.  
  1161.       Find Area Code Documentation
  1162.      ----------------------------
  1163.  
  1164.  
  1165.      The "/I" Switch
  1166.      ---------------
  1167.  
  1168.      Used to install FAC as a swapping or non-swapping TSR.  Can NOT be
  1169.      used in the FAC environment variable.
  1170.  
  1171.      The /I switch says, "Install FAC as a memory resident program using
  1172.      its defaults and/or other switches." If you use /I by itself, the
  1173.      program will install itself using several predefined defaults, all of
  1174.      which can be changed by using other switches.
  1175.  
  1176.      If you use /I alone to install FAC, the following defaults are used:
  1177.  
  1178.        - Swapping to disk is enabled unless sufficient EMS memory is found.
  1179.        - Messages which tell you swapping is happening are enabled.
  1180.        - Disk swap files will be hidden/system files.
  1181.        - The disk and directory path FAC uses for swap files is the same
  1182.          disk/directory where FAC found FAC.DAT.
  1183.        - AutoZoom is on.
  1184.        - Exploding windows are enabled (see the /X switch above).
  1185.  
  1186.      After you use the /I switch to install FAC, you will see a status
  1187.      message which describes the state of each of the above defaults.
  1188.  
  1189.      Note that if FAC is already installed, you won't be able to install a
  1190.      second copy.  If you try to install it again, you'll get an error
  1191.      message and the installation will abort.
  1192.  
  1193.      If you don't have enough disk space for the swap files, you'll get an
  1194.      error message and FAC won't install as a TSR.
  1195.  
  1196.      After you install FAC as a TSR, don't move or rename the FAC.DAT file
  1197.      or you will probably get dumped from the TSR when you try to use it.
  1198.  
  1199.      Please note that you can't pop up FAC when you're using a program
  1200.      which is currently in graphics mode.  If you try to pop it up, you'll
  1201.      hear a beep and nothing else will happen.
  1202.  
  1203.      Be aware that since FAC swaps the currently running program out so FAC
  1204.      can become active, you could have a problem with some programs,
  1205.      especially communications programs.  It isn't advisable to pop up any
  1206.      TSR when a communications program if data is coming in or going out.
  1207.  
  1208.      FAC should work fine with most other TSRs.  The only problem you may
  1209.      encounter is when you don't load FAC last among other TSRs.  This
  1210.      won't hurt anything, but you may not have access to your other TSRs
  1211.      when FAC is swapped in (since it may have swapped the other TSR(s) out
  1212.      of RAM).   If FAC isn't in use, or it's been installed as a non-
  1213.      swapping TSR, you shouldn't have a problem with TSRs loaded after it.
  1214.  
  1215.  
  1216.      -------
  1217.      Page 21
  1218.  
  1219.       Find Area Code Documentation
  1220.      ----------------------------
  1221.  
  1222.  
  1223.      Don't attempt to install FAC while you're "shelled out" of other
  1224.      programs.  For example, you can drop temporarily to DOS from many
  1225.      programs, but you should never try to install FAC while you're doing
  1226.      so.  This also applies to many menu programs like PowerMenu and
  1227.      AutoMenu.  These programs can leave a portion of themselves in memory.
  1228.      You should never try to install FAC as a TSR from any menu program.
  1229.      Completely exit from any other program before attempting to install
  1230.      FAC as a TSR.  You may run FAC from the DOS prompt (non-TSR) while
  1231.      shelled out of another program if you wish.
  1232.  
  1233.      Example:  "FAC /I"
  1234.  
  1235.      This would install FAC as a TSR with the defaults described above.
  1236.  
  1237.  
  1238.      The "/M" Switch
  1239.      ---------------
  1240.  
  1241.      Used with /I when installing FAC as a swapping TSR.  Can be used in
  1242.      the FAC environment variable.
  1243.  
  1244.      The /M switch says, "don't put the swapping in/out... messages at the
  1245.      bottom of the screen when swapping."  The program doesn't work any
  1246.      differently, except that you won't see the messages.  If you use EMS
  1247.      memory (the default if you have EMS installed), or a RAM disk for
  1248.      swapping, the swapping messages might be an unnecessary distraction.
  1249.  
  1250.      The default is to have swapping messages appear.
  1251.  
  1252.      Example: "FAC /I /M"
  1253.  
  1254.      This would install FAC as a swapping TSR, but swapping messages would
  1255.      be disabled.
  1256.  
  1257.  
  1258.      The "/N" Switch
  1259.      ---------------
  1260.  
  1261.      Used with /I to install FAC as a non-swapping TSR.  Can be used in the
  1262.      FAC environment variable.
  1263.  
  1264.      The /N switch says, "NO swapping; don't use the swapping TSR mode;
  1265.      keep the entire TSR in RAM."  This will give you instant access to FAC
  1266.      when  you press the hotkey, but requires about 140K of RAM.  If you
  1267.      have plenty of RAM, need FAC to be available instantly, and use
  1268.      programs which won't miss the memory FAC requires in this mode, use
  1269.      the /N switch.
  1270.  
  1271.      The default is a swapping TSR.
  1272.  
  1273.  
  1274.      -------
  1275.      Page 22
  1276.  
  1277.       Find Area Code Documentation
  1278.      ----------------------------
  1279.  
  1280.  
  1281.      Example:  "FAC /I /N"
  1282.  
  1283.      This would install FAC as a non-swapping TSR.
  1284.  
  1285.  
  1286.      The "/P" Switch
  1287.      ---------------
  1288.  
  1289.      Used with /I when installing FAC as a swapping TSR.  Can be used in
  1290.      the FAC environment variable.
  1291.  
  1292.      The /P switch, when followed by a complete path specification, says,
  1293.      "put the swap files in the specified disk/directory."  The path
  1294.      specification must be a valid, already existing disk/directory, and
  1295.      must be less than 127 characters.  Do not put a backslash on the end
  1296.      of the path specification (unless you're using the root directory of
  1297.      the specified disk).  In other words, use the same format for the /P
  1298.      path specification that you would for a normal DOS PATH statement.
  1299.  
  1300.      The main reason you would use this switch would be to tell FAC to use
  1301.      a RAM disk. If you have a RAM disk, with at least 250K of space, you
  1302.      should use the /P switch to significantly speed up swapping.  If you
  1303.      use /P to swap to RAM disk, you may wish to use the /M switch to
  1304.      disable the swapping in/out messages.
  1305.  
  1306.      It's highly inadvisable to use a removable (floppy) disk for the swap
  1307.      path.  You won't harm anything, but you could lock up your machine and
  1308.      have to reboot if the disk isn't there when swapping needs to occur.
  1309.  
  1310.      Whether you use the /P option or not, FAC generates either one or two
  1311.      swap files, named FAC-SWP1.$$$ and FAC-SWP2.$$$, each about 130K in
  1312.      size, located wherever FAC.DAT was found (unless you specify otherwise
  1313.      with the /P switch).  These files are marked with both System and
  1314.      Hidden attributes to make it less likely you will accidentally delete
  1315.      them unless you use the /A option).  If they are deleted after FAC is
  1316.      loaded, and you try to pop up the program, you'll get an error message
  1317.      and you'll have to reboot.  When you successfully unload FAC, the swap
  1318.      files are deleted.  If you reboot or turn your machine off, the
  1319.      file(s) will remain, but will be written over the next time FAC is
  1320.      loaded as a TSR.
  1321.  
  1322.      The default is to put swap files in the same disk/directory where
  1323.      FAC.DAT was found.  If you aren't sure where this is, run FAC with a
  1324.      /? and look at the default determined by the program at run time.
  1325.  
  1326.      Examples: "FAC /I /Pd:" "FAC /I /Pc:\junk
  1327.  
  1328.                "FAC /I /Pc:\temp\" <== WRONG!! No backslash after the path!
  1329.  
  1330.      The first example would install FAC as a swapping TSR with the swap
  1331.  
  1332.      -------
  1333.      Page 23
  1334.  
  1335.       Find Area Code Documentation
  1336.      ----------------------------
  1337.  
  1338.  
  1339.      files located on the D: drive.  The second example would use a swap
  1340.      file directory called C:\JUNK.  The third example is an invalid path
  1341.      name and would give an error.
  1342.  
  1343.  
  1344.      The "/T" Switch
  1345.      ---------------
  1346.  
  1347.      Used for both non-TSR and TSR.  Can be used in the FAC environment
  1348.      variable.
  1349.  
  1350.      This option or program "switch" applies to FAC when run from the DOS
  1351.      prompt (non-memory resident mode) or when you install it as a popup.
  1352.      If you use the "/T" switch, FAC will disable its use of the AutoZoom
  1353.      screen-sizing feature.  If you use this option, it means that when a
  1354.      large number of lines needs to be displayed, the screen won't
  1355.      automatically zoom to full size to show you as much text as possible.
  1356.  
  1357.      You may be able to uninstall FAC by using something like TurboPower
  1358.      Software's excellent (and free!) Mark/Release (TSRCOM) utilities, but
  1359.      even then, you must remove FAC and all TSRs loaded after it.  If you
  1360.      plan to frequently uninstall FAC you should load it last.  Of course
  1361.      if you load FAC last, then you won't be able to unload TSRs loaded
  1362.      before it.  Naturally, you can uninstall any TSR by rebooting your
  1363.      machine.
  1364.  
  1365.      Example: "FAC /U"
  1366.  
  1367.      This example uninstalls FAC if no other TSRs were installed after it.
  1368.  
  1369.      Note that you can also uninstall FAC from inside the program by
  1370.      pressing Alt-U twice in succession.
  1371.  
  1372.  
  1373.      The "/X" Switch
  1374.      ---------------
  1375.  
  1376.      Used for both non-TSR and TSR.  Can be used in the FAC environment
  1377.      variable.
  1378.  
  1379.      This option or program "switch" applies to FAC when run from the DOS
  1380.      prompt (non-memory resident mode) or when you install it as a popup.
  1381.      If you use the "/X" switch, FAC will disable its use of exploding
  1382.      windows.  Exploding windows don't change the way the program searches
  1383.      or the way you use it, it just changes how the program looks when it
  1384.      starts and finishes.
  1385.  
  1386.      If you want to disable exploding windows when you run the program from
  1387.      the DOS command line (non-TSR), just put the /X switch after your
  1388.      search parameter.
  1389.  
  1390.      -------
  1391.      Page 24
  1392.  
  1393.       Find Area Code Documentation
  1394.      ----------------------------
  1395.  
  1396.  
  1397.  
  1398.      Example:  "FAC boulder /x"
  1399.  
  1400.      When the program starts, the window would appear instantly on the
  1401.      screen instead of being exploded onto the screen.
  1402.  
  1403.  
  1404.      The "/Z" Switch
  1405.      ---------------
  1406.  
  1407.      Used for both non-TSR and TSR.  Can be used in the FAC environment
  1408.      variable.
  1409.  
  1410.      This option applies to FAC when run from the DOS prompt (non-memory
  1411.      resident mode) or when you install it as a popup.  If you use the "/Z"
  1412.      switch, FAC will "zoom" its window to take up the entire screen.
  1413.  
  1414.      Example:  "FAC TX /Z"
  1415.  
  1416.      When the program starts, the window takes up the entire screen.  You
  1417.      might want to use this option if you're viewing lists of area codes or
  1418.      all the area codes for one state.
  1419.  
  1420.  
  1421.      Error Conditions
  1422.      ----------------
  1423.  
  1424.      FAC is very friendly and shouldn't give error messages unless there's
  1425.      really something you need to fix.  Here are some error messages FAC
  1426.      could generate and why you might get them:
  1427.  
  1428.      - "Error while trying to find/open FAC.DAT"   Make sure FAC.DAT exists
  1429.         and that the disk and directory containing FAC.DAT is on your DOS
  1430.         path.
  1431.  
  1432.      - "XXXX is an invalid path name!"  You've specified an incorrect path
  1433.         when using the /P switch or the path you've specified is too long
  1434.         the limit is 127 characters)
  1435.  
  1436.      - "XXXX is an invalid file name!"  You've specified an incorrect file
  1437.         when using the /D switch.
  1438.  
  1439.      - "FAC isn't loaded!"  You've tried to uninstall FAC (as a TSR) when
  1440.         it wasn't previously loaded.  Use the /I option to install it.
  1441.  
  1442.      - "Unable to unload FAC.  Probably isn't safe to do so!"  This isn't
  1443.         really an error message; it just means that the program can't
  1444.         uninstall itself, probably because there's another TSR or program
  1445.         loaded after it. Try rebooting if you have to unload it.
  1446.  
  1447.  
  1448.      -------
  1449.      Page 25
  1450.  
  1451.       Find Area Code Documentation
  1452.      ----------------------------
  1453.  
  1454.  
  1455.      - "XXXX not found."  This, too, isn't really an error message. You'll
  1456.         get this message any time you searched for string and it wasn't
  1457.         found. The string you're searching for may not be in FAC.DAT or you
  1458.         may need to check your spelling.  Try the fuzzy search mode if you
  1459.         aren't sure of the spelling.
  1460.  
  1461.      - "FAC is already memory resident!"  You're trying to install FAC
  1462.         after it's already been loaded.  Use FAC /U to uninstall it.
  1463.  
  1464.      - "Unable to go TSR."   This message means FAC couldn't go TSR,
  1465.         probably because you don't have enough RAM, you don't have enough
  1466.         disk space for the swap files, or you're trying to load the TSR
  1467.         high (because FAC is a swapping TSR, it can't be loaded high).
  1468.  
  1469.      - "Couldn't make window!"  There was a memory allocation error when
  1470.         FAC tried to draw its window.  You probably don't have enough RAM
  1471.         to run FAC.
  1472.  
  1473.  
  1474.      Technical/Compatibility Notes
  1475.      -----------------------------
  1476.  
  1477.      Find Area Code runs on IBM PC compatibles (clones) using DOS 3.XX and
  1478.      4.01, and MS-DOS 5.0.  It probably won't work with DOS 2.X since 2.X
  1479.      handles paths differently.  It might work if you're in the same
  1480.      directory as the data file.
  1481.  
  1482.      FAC is "DESQview-aware" in the sense that it will disable
  1483.      direct-screen writing when it detects the presence of DESQview.  FAC
  1484.      runs well in a small (160K) DESQview window.
  1485.  
  1486.      FAC is written using Borland's Turbo Pascal 6.0 and TurboPower
  1487.      Software's excellent Object Professional 1.1.  One of the reasons the
  1488.      program searches so quickly is RLINE, Don Strenczewilk's excellent
  1489.      Turbo Pascal OOP text file handling unit.  RLINE allows you to define
  1490.      a "file of lines" object.  Thanks to Don for graciously donating his
  1491.      code to the public domain!
  1492.  
  1493.  
  1494.      How to Reach the Author
  1495.      -----------------------
  1496.  
  1497.                    Michael K. Molloy
  1498.                    Mountain Data Systems
  1499.                    8531 East Dry Creek Place
  1500.                    Englewood, CO  80112
  1501.                    CIS: 72737,3237
  1502.  
  1503.      CompuServe Information Service (CIS) is the best place to reach me,
  1504.      but I also frequent the MicroManiac!, Tom Gettys' fantastic Wildcat
  1505.  
  1506.      -------
  1507.      Page 26
  1508.  
  1509.       Find Area Code Documentation
  1510.      ----------------------------
  1511.  
  1512.  
  1513.      BBS (303-673-9470) in Lafayette, CO.  I would be happy to provide
  1514.      electronic support there, if you wish.  His board should always have
  1515.      the latest version of Find Area Code (and hundreds of other fresh
  1516.      uploads!).
  1517.  
  1518.  
  1519.      Alternative Uses
  1520.      ----------------
  1521.  
  1522.      You may have thought to yourself as you used FAC, "Hmmm, if I can pop
  1523.      FAC up anywhere as a tiny TSR, and if I can change the contents of the
  1524.      FAC.DAT file and the external data file, why can't I put my own
  1525.      personal information into it and quickly and conveniently search for
  1526.      it when I need it?"  You can, and I hope you will.
  1527.  
  1528.      I think the ease of modifying FAC's database is a very valuable
  1529.      feature.  In fact, one of the reasons I decided to write "yet another
  1530.      area code finder" was the frustration I had with the fact you couldn't
  1531.      modify, correct, update, or add to some of the other area code program
  1532.      data files.  My own personal use of FAC goes far beyond just using it
  1533.      to hunt down area codes.  Here's what I do.
  1534.  
  1535.      I have (you probably do, too if you're any kind of computer nut) a
  1536.      database of friends and relatives with which I maintain a quick
  1537.      reference phone list.  Periodically, I use my database program to
  1538.      generate a report which I print to disk.  The report looks something
  1539.      like this:
  1540.  
  1541.      John Doe            555-555-5555  1234 Anywhere St., Anyplace, CO
  1542.      12345
  1543.      Joe's Software Shop     555-1234  (open 24 hours)
  1544.      Jay's Hardware Emporium 555-9876  (Closes at 6pm)
  1545.      Jim Smith               555-0000  (Keep trying; has teenagers on
  1546.      phone)
  1547.      ...
  1548.      (you get the idea)
  1549.  
  1550.      I use an editor to paste the ASCII information into the MY-DATA.DAT
  1551.      file and presto, I have a 7K popup database of our family and friends.
  1552.      It can be anywhere in the file, in any format, in any order since
  1553.      every character of the entire file is searched every time.
  1554.  
  1555.      Obviously, if you change the data file to reflect your own data, it
  1556.      could be used for almost anything.  Just remember, the program is
  1557.      line-oriented--all the information for one "record" must be on the
  1558.      same line.  Each line in the data file is limited to 119 characters.
  1559.      If lines are longer than 119 characters, they'll be truncated when
  1560.      they are displayed.  The program will automatically wordwrap lines of
  1561.      up to 119 characters when the "record" is displayed.
  1562.  
  1563.  
  1564.      -------
  1565.      Page 27
  1566.  
  1567.       Find Area Code Documentation
  1568.      ----------------------------
  1569.  
  1570.  
  1571.      I guess the way I use FAC makes it kind of a "poor man's personal
  1572.      information manager (PIM)".  I've found that FAC is far superior to
  1573.      LIST and other text file handling programs when it comes to ease of
  1574.      use, search speed, and the ability to be memory resident.
  1575.  
  1576.      FAC certainly isn't offered as any kind of free format database
  1577.      package, but I think it bridges an important gap between a full-blown
  1578.      database application and a tattered piece of paper taped above your
  1579.      computer desk.  I think this capability gives FAC significant "value
  1580.      added."  I hope you agree and see this as another reason to support
  1581.      the program with your registration.
  1582.  
  1583.      Use your imagination!  One user of FAC uses it to look up Portugeuse
  1584.      words and phrases he entered in the data file!  If you come up with
  1585.      radical or useful new applications for Find Area Code "engine", please
  1586.      let me know.
  1587.  
  1588.  
  1589.      Final Remarks
  1590.      -------------
  1591.  
  1592.      Many thanks to my wife, Bobbea, for her friendship, love, and support
  1593.      in every aspect of my life.  Thanks to Tom Gettys and George Clifford
  1594.      for their valuable beta test feedback and for having the best BBSs in
  1595.      Colorado!  Thanks to members of the Association of Shareware
  1596.      Professionals, especially Paul Mayer and Bob Falk for advice on
  1597.      shareware and for some of the boilerplate text for my documentation.
  1598.  
  1599.      I've made every effort to provide the correct area codes and foreign
  1600.      country city codes.  If you find errors or additions, please let me
  1601.      know.
  1602.  
  1603.      NOTE: Your registration and support for this program will enable me to
  1604.      continue to develop FAC and add other valuable features in future
  1605.      versions:
  1606.  
  1607.          - Capability to set user defaults (colors/hotkey/etc.)
  1608.          - Extended "record" length
  1609.          - You tell me.
  1610.  
  1611.      If FAC doesn't do what you think it should, or you'd like for it to do
  1612.      something else, I would be happy to develop a customized version of
  1613.      the program for anyone who wants one (for a reasonable fee).  I'd
  1614.      appreciate bug reports, new feature requests, comments, performance
  1615.      problems, constructive criticism, suggestions, additions, and/or
  1616.      corrections regarding Find Area Code.
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.      -------
  1623.      Page 28
  1624.  
  1625.       Find Area Code Documentation
  1626.      ----------------------------
  1627.  
  1628.  
  1629.                    Quick Reference List of FAC Switch Options
  1630.                    ------------------------------------------
  1631.  
  1632.      /A               When used with /I & disk swapping, don't use
  1633.                       hidden/system attributes on swap files
  1634.  
  1635.      /B               Don't use color screen attributes; use monochrome
  1636.                       (black & white) only
  1637.  
  1638.      /C               Use the normal (am/pm) clock format in the on-screen
  1639.                       clock (rather than the 24-hour format.
  1640.  
  1641.      /Dfilename.ext   Use the specified file name as the external data file
  1642.                       to search/add to
  1643.  
  1644.      /E               When used with /I, don't use Expanded Memory (EMS)
  1645.                       even if it's available; use disk swapping
  1646.  
  1647.      /F               Enables "fuzzy search" mode to find sound-alike,
  1648.                       approximate spellings
  1649.  
  1650.      /G               When used with /I, don't read text from screen
  1651.  
  1652.      /H               Show a help screen of options & descriptions
  1653.  
  1654.      /I               Loads popup/TSR with defaults:
  1655.                         - Swap using EMS memory (or disk if no EMS)
  1656.                         - Swapping messages on
  1657.                         - Swap files have hidden/system attributes
  1658.                         - Swap file path = same path FAC.DAT found on
  1659.                         - Exploding windows on
  1660.                         - AutoZoom is On
  1661.                         - Read search string from screen
  1662.  
  1663.      /M               When used with /I; suppresses swapping messages
  1664.  
  1665.      /N               When used with /I, loads popup; no swapping (instant
  1666.                       popup mode, but requires 140K RAM)
  1667.  
  1668.      /Pc:\temp        When used with /I, loads popup: path for swap files =
  1669.                       c:\temp; Specify RAM disk if possible
  1670.  
  1671.      /T               Don't use the AutoZoom feature
  1672.  
  1673.      /U               If installed as a TSR, unloads popup from memory, if
  1674.                       possible; deletes swap files
  1675.  
  1676.      /X               Don't use exploding windows
  1677.  
  1678.      /Z               Use a "zoomed" window which uses the full screen
  1679.  
  1680.      -------
  1681.      Page 29
  1682.  
  1683.